home *** CD-ROM | disk | FTP | other *** search
/ Gigantic Games 2 / Gigantic Games 2.iso / pc / _w_ / wb_tetris / wbtris_1.4 / wbtris.doc < prev    next >
Text File  |  1994-12-23  |  9KB  |  247 lines
  1.          WBTRIS V1.4 - Manual
  2.  
  3.  
  4. NAME
  5.  
  6.    WBTRIS
  7.  
  8. DESCRIPTION
  9.  
  10.    Little Tetris-Game with many Options.
  11.    Runs only under Release 2.0 or higher of Workbench.
  12.  
  13. SOURCE
  14.  
  15.    The source code is included, it can be compiled with
  16.    Dice V2.06.37 (registered version only) (or newer).
  17.  
  18. COPYRIGHT
  19.  
  20.    WBTRIS is 'Cardware'. This means that it has the same restrictions as
  21.    public-domain but if you enjoy this game please send a postcard or
  22.    an E-Mail-message to one of us.
  23.    WBTRIS is free to be spread on public-domain and shareware disks, as
  24.    long as they are sold for a reasonable charge that is less than $6 or
  25.    DM 8,-. For use in commercial products the permission of the author is
  26.    required.
  27.    WBTRIS may be copied and distributed via electronic networks such
  28.    as the Internet, also it may be moved on anonymous ftp-servers,
  29.    mail-boxes or BBS's.
  30.  
  31. AUTHOR
  32.  
  33.    Ralf Pieper
  34.    Peter-Hille-Weg 4
  35.    D-3533 Willebadessen
  36.    Germany
  37.  
  38.    Dirk Böhmer
  39.    Friedr.-Wilh.-Weber-Str. 18
  40.    D-3533 Willebadessen
  41.    Germany
  42.  
  43.    INTERNET: medusa@uni-paderborn.de
  44.    IRC: Medusa
  45.  
  46.    Any comments are welcome.
  47.  
  48. VERSION
  49.  
  50.    1.4
  51.  
  52. STARTING
  53.  
  54.    From Shell :
  55.  
  56.       Just type 'WBTRIS'
  57.       But have also a look at the shellarguments!
  58.  
  59.    From Workbench :
  60.  
  61.       Double-click on its icon.
  62.       WBTRIS is now started.
  63.  
  64. SYSTEM REQUIREMENTS
  65.  
  66.    Runs under Workbench 2.04 and newer.
  67.    You need the font 'helvetica 13'!
  68.    You need the following libraries:
  69.       - mathieeedoubbas.library
  70.       - mathieeedoubtrans.library
  71.       - diskfont.library
  72.  
  73. USING AND PLAYING WBTRIS
  74.  
  75.    If you have specified an ENV-variable 'WBTRIS' with includes a path and filename
  76.    (for example: 'setenv WBTRIS "S:WBTRIS.scores"'), the hiscore-file will be
  77.    saved to this path/filename.
  78.  
  79.    In the left upper corner there is a field where you can see the next tile
  80.    while playing. Switch it on or off in the options window.
  81.  
  82.    Below that place you can find 4 displays to show the hiscore, score, level
  83.    and how many lines you have made.
  84.  
  85.    Below these displays are some Gadgets.
  86.       Pause/Go on:   When you click on this gadget the playfield will be erased
  87.                      and a little 'pause-picture' will be shown. The gadget text
  88.                      is now 'Go on'. Another click lets you return to your game
  89.                      and restores the playfield.
  90.  
  91.       Statistic:     You get a little window with a statistic about the number
  92.                      of the tiles fallen down. You can press this button only
  93.                      in pause-mode.
  94.  
  95.       Options:       See 'OPTIONS WINDOW'
  96.  
  97.       New game:      The playfield will be cleared, a little window pops up
  98.                      and shows the 10 best players. After closing this window
  99.                      a new game begins.
  100.  
  101.       Quit game:     This gadget is to quit the game. Same function as to
  102.                      close the window.
  103.  
  104.    To control the tilemovements you have 5 keyboardkeys, which are:
  105.       Return (default):        lets the tile fall down to ground
  106.  
  107.       Space (default):         lets the tile fall down quicker than normal
  108.  
  109.       Cursor right (default):  lets the tile move to the right
  110.  
  111.       Cursor left (default):   lets the tile move to the left
  112.  
  113.       Cursor up (default):     lets the tile rotate to the right
  114.  
  115.       Cursor down (default):   lets the tile rotate to the left
  116.  
  117. ARGUMENTS
  118.  
  119.    LEFT=LEFTEDGE/N/K:      left Edge of WBTRIS' window
  120.    TOP=TOPEDGE/N/K:        top Edge of WBTRIS' window
  121.    N=NAME/K:               Name of the player
  122.    NOLOCK=NOLOCKNAME/K/S:  if 'NOLOCKNAME' every new game the optionswindow
  123.                            will pop up to ask for another name. The 'NAME'
  124.                            argument is switched off.
  125.    NONEXT=SHOWNONEXT/K/S:  if 'SHOWNONEXT' the preview to the next object is off
  126.    NOLACE/K/S:             if 'NOLACE' you can play the noninterlace game
  127.    LEVEL/N/K:              number of the startlevel
  128.    PULLDOWNTICKS/N/K:      number of the speed to pull down the tiles
  129.    R=MOVERIGHT/K:          rawkey for the tilemovement to the right
  130.    L=MOVELEFT/K:           rawkey for the tilemovement to the left
  131.    RR=ROTATERIGHT/K:       rawkey for the tilerotating to the right
  132.    RL=ROTATELEFT/K:        rawkey for the tilerotating to the left
  133.    D=MOVEDOWN/K:           rawkey for the quicker tiledownmovement
  134.    DQ=MOVEDOWNQUICK/K:     rawkey to let the tiles fall down to ground
  135.  
  136. TOOLTYPES
  137.  
  138.    WBTRIS supports Tool Type entries. Click the WBTRIS.info and press
  139.    Right-Amiga and i to change or add a Tool Type entry.
  140.  
  141.    In the Tool Type list there is entered:
  142.  
  143.       LEFTEDGE         # Windowoffset
  144.       TOPEDGE          # Windowoffset
  145.       NAME             # Your name
  146.       LOCKNAME         # If TRUE then the name is locked during the game (TRUE/FALSE)
  147.       SHOWNEXT         # The next tile will be shown (TRUE/FALSE)
  148.       LEVEL            # Startlevel (0-20)
  149.       PULLDOWNSPEED    # Speed to pulldown the tiles (0-20)
  150.       MOVERIGHT        # rawkey to move the tile to the right (default '0X4e')
  151.       MOVELEFT         # rawkey to move the tile to the left (default '0X4f')
  152.       ROTATERIGHT      # rawkey to rotate the tile to the right (default '0X4c')
  153.       ROTATELEFT       # rawkey to rotate the tile to the right (default '0X4d')
  154.       MOVEDOWN         # rawkey to move the tile down faster (default '0X40')
  155.       MOVEDOWNQUICK    # rawkey to let the tile fall down to ground (default '0X44')
  156.       USELACE          # If TRUE then the lace version will be started, if FALSE
  157.                          then the noninterlace version will be started
  158.  
  159. OPTIONS WINDOW
  160.  
  161.    You will see some Gadgets and  Sliders.
  162.  
  163.    The values inside the Gadgets are via default set to the
  164.    supplied Arguments in the Tool Types.
  165.  
  166.    STARTLEVEL:    The specified value for the Startlevel of the
  167.          game. The higher the faster is the game.
  168.          shows up. Value may between 0 and 20.
  169.  
  170.    PULLDOWNSPEED:    The value for the speed of the stones when Space
  171.          is pressed. The higher the faster are the sones. Value may
  172.          between 0 and 20.
  173.  
  174.    NAME:    Your Name.
  175.  
  176.    NAMEOPTIONS:     Enter value between ´lock name´ and ´ask name´.
  177.          Lock name is for the same name during the whole time of playing.
  178.          Ask name is for reenter the name after every game.
  179.  
  180.    SHOWNEXTOBJECT:     Show the next object to come. If inactive the
  181.          next Object is hidden.
  182.  
  183.    INFO:    Opens a Information-Window.
  184.  
  185.    OK:      Play the game.
  186.  
  187. CREDITS:
  188.  
  189.    Matt Dillon for Dice. So we could make WBTRIS be compilable in
  190.    the most common low-cost C-Compiler. (Only registered version)
  191.    Ah, yes. Greetings to Stefan Becker! :-)
  192.  
  193.    Fred Fish, Mr. Public Domain, hope you like this enough to place
  194.    it onto one of your new 'Fishes'. Permission herebye given.
  195.  
  196.    Commodore Amiga group for this great system. Hope to see some
  197.    great new stuff this year !
  198.  
  199.    Special thanks to Markus Stipp (corwin), Matthias Scheler (tron),
  200.    Michael Janich (massa), Aurel Balmosan (aurel), Frank Paetschke
  201.    and Guido Wulf for their great help and new ideas.
  202.  
  203.    Thanks for all emails.
  204.  
  205.    Our first postcard (remember the game is CARDWARE) was written by
  206.    Edith Parzefall ! Thanx Edith.
  207.  
  208. HISTORY
  209.  
  210.    Version 1.0:
  211.       - Our first release
  212.  
  213.    Version 1.1 (internal release):
  214.       - Supports the ENV-variable 'WBTRIS'. There you can specify the name
  215.         (including its path) of the hiscore-file. If this variable doesn't
  216.         exist, the current directory will be taken
  217.       - Better written document (sorry for the first one!)
  218.       - you can define your own keys to move the tiles (rawkey-codes)
  219.       - options-window with a correct size
  220.  
  221.    Version 1.2:
  222.       - error-messages with EasyRequest()
  223.       - error-message if screen is too small
  224.       - statistic function implemented
  225.       - fixed a bug in rotate-function
  226.       - bug fix: startlevelspeed of the first tile was wrong
  227.  
  228.    Version 1.3:
  229.       - supports interlace/noninterlace screens, you can switch
  230.         it with the tooltype 'USELACE'
  231.       - now WBTRIS uses the timer.device to control the gamespeed
  232.       - another keyboard key to let a tile fall down to ground
  233.       - supports arguments when starting from shell
  234.       - bug fix: on screens with more than 8 colors the WBTRIS logo now has the correct outfit
  235.  
  236.    Version 1.4:
  237.       - new scoreing (more points in higher levels)
  238.       - name is asked if there is no name given
  239.       - additionally the level is saved in the hiscoretable
  240.       - WBTRIS opens the nolace version on nolace screens automatically
  241.       - WBTRIS uses helvetica/13 in the hiscore and statistic window (only lace version)
  242.       - you can press any key to close the statistic or hiscore window
  243.  
  244. FINAL
  245.  
  246.    We wish you a lot of fun with the game !!!
  247.